package com.shlh.saas.service.twitter;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.shlh.saas.entity.twitter.TwitterUser;
import com.shlh.saas.model.dto.TwitterQueryDTO;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;
import java.util.Map;

/**
 * Twitter用户服务接口
 */
public interface TwitterService extends IService<TwitterUser> {
    
    /**
     * 根据邮箱查询Twitter用户
     * @param email 邮箱
     * @return Twitter用户
     */
    List<TwitterUser> findByEmail(String email);
    
    /**
     * 根据推特账号查询Twitter用户
     * @param screenName 推特账号
     * @return Twitter用户
     */
    TwitterUser findByScreenName(String screenName);
    
    /**
     * 分页查询Twitter用户列表
     */
    Page<TwitterUser> getTwitterUserPage(TwitterQueryDTO queryDTO);
    
    /**
     * 导出Twitter用户数据
     */
    List<TwitterUser> exportTwitterUsers(TwitterQueryDTO queryDTO);
    
    /**
     * 根据ID获取Twitter用户
     */
    TwitterUser getTwitterUserById(Integer id);
    
    /**
     * 分页查询Twitter用户数据
     * @param queryDTO 查询参数
     * @return 分页结果
     */
    Page<TwitterUser> getTwitterUsersPage(TwitterQueryDTO queryDTO);
    
    /**
     * 获取Twitter用户列表（不分页）
     * @param queryDTO 查询参数
     * @return Twitter用户数据列表
     */
    List<TwitterUser> getTwitterUsersList(TwitterQueryDTO queryDTO);
    
    /**
     * 导入Twitter用户数据
     * @param file Excel文件
     * @return 导入的Twitter用户列表
     * @throws Exception 导入异常
     */
    List<TwitterUser> importTwitterUsers(MultipartFile file) throws Exception;
    
    /**
     * 在所有字段中搜索关键词
     * 
     * @param keyword 搜索关键词
     * @param offset 偏移量
     * @param limit 限制数量
     * @return 符合条件的数据列表
     */
    List<Map<String, Object>> searchByKeywordInAllFields(String keyword, int offset, int limit);
    
    /**
     * 统计所有字段中包含关键词的记录数量
     * 
     * @param keyword 搜索关键词
     * @return 记录总数
     */
    long countByKeywordInAllFields(String keyword);
    
    /**
     * 获取搜索建议
     * 
     * @param keyword 关键词
     * @return 搜索建议列表
     */
    List<String> getSuggestions(String keyword);
    
    /**
     * 获取所有Twitter用户数据
     * @return Twitter用户数据列表
     */
    List<TwitterUser> getAllTwitterUsers();

    /**
     * 统计符合条件的Twitter用户数量
     * @param keyword 搜索关键词
     * @return 记录总数
     */
    long countTwitterUsersByKeyword(String keyword);
    
    /**
     * 统计符合查询条件的Twitter用户数量
     * @param queryDTO 查询参数
     * @return 记录总数
     */
    long countTwitterUsers(TwitterQueryDTO queryDTO);

    List<TwitterUser> searchTwitterUsersWithEmail(String searchKeyword, int offset, int size);

    Long countTwitterUsersWithEmail(String searchKeyword);

    List<Map<String, Object>> searchByEmail(String value, int size, int offset);

    /**
     * 获取Twitter用户的完整联系信息
     * @param sourceId 数据源ID
     * @param sourceTable 数据源表名
     * @param field 需要获取的字段名称
     * @return 返回包含完整字段信息的Map
     */
    Map<String, String> getFullContactInfo(String sourceId, String sourceTable, String field);

    List<TwitterUser> searchTwitterData(String companyName, String fullName, Integer matchType);
    
    /**
     * 根据关键词从ES查询标识信息（用于批量查询）
     * @param keyword 搜索关键词
     * @param offset 偏移量
     * @param limit 限制数量
     * @return 包含sourceTable和sourceId的标识信息列表
     */
    List<Map<String, String>> searchByKeyWordForIdentifiers(String keyword, int offset, int limit);

    List<Map<String, Object>> searchByKeyword(String keyword, int offset, int limit);
    
    /**
     * 根据姓名和用户名从ES查询标识信息（用于批量查询）
     * @param name 姓名
     * @param username 用户名（screen_name）
     * @param limit 限制数量
     * @return 包含sourceTable和sourceId的标识信息列表
     */
    List<Map<String, Object>> searchByNameAndUsernameForIdentifiers(String name, String username, int limit);
}